Linear
Linear
Linear MCP 서버는 Linear 프로젝트 관리 시스템과 상호작용할 수 있는 Model Context Protocol 서버입니다. 이 서버를 통해 AI 어시스턴트는 Linear의 이슈, 프로젝트, 팀 관리 기능에 접근하여 작업을 자동화하고 효율적인 프로젝트 관리를 지원할 수 있습니다.
특징
- Linear 이슈 생성, 업데이트, 검색 및 관리
- 팀별 이슈 목록 조회 및 필터링
- 사용자별 할당된 이슈 관리
- 이슈에 코멘트 추가 및 소통
- 우선순위, 상태, 레이블 등 이슈 속성 관리
- 자연어를 통한 이슈 검색 및 필터링
- 조직 및 팀 정보 조회
- 마크다운 지원 설명 및 코멘트 작성
API
리소스
linear-issue:///{issueId}
- 개별 이슈의 세부 정보를 조회합니다.
linear-team:///{teamId}/issues
- 특정 팀의 모든 이슈를 조회합니다.
linear-user:///{userId}/assigned
- 특정 사용자에게 할당된 이슈를 조회합니다.
linear-organization:
- 조직 정보를 조회합니다.
linear-viewer:
- 현재 사용자 컨텍스트를 조회합니다.
도구
linear_create_issue
새로운 Linear 이슈를 생성합니다. - 필수 입력: - title (string): 이슈 제목 - teamId (string): 이슈를 생성할 팀 ID - 선택적 입력: - description (string): 이슈 설명 (마크다운 지원) - priority (number, 0-4): 우선순위 수준 (1=긴급, 4=낮음) - status (string): 초기 상태 이름
linear_update_issue
기존 이슈를 업데이트합니다. - 필수 입력: - id (string): 업데이트할 이슈 ID - 선택적 입력: - title (string): 새 제목 - description (string): 새 설명 - priority (number, 0-4): 새 우선순위 - status (string): 새 상태 이름
linear_search_issues
유연한 필터링으로 이슈를 검색합니다. - 선택적 입력: - query (string): 제목/설명에서 검색할 텍스트 - teamId (string): 팀으로 필터링 - status (string): 상태로 필터링 - assigneeId (string): 담당자로 필터링 - labels (string[]): 레이블로 필터링 - priority (number): 우선순위로 필터링 - limit (number, 기본값: 10): 최대 결과 수
linear_get_user_issues
사용자에게 할당된 이슈를 가져옵니다. - 선택적 입력: - userId (string): 사용자 ID (생략 시 인증된 사용자) - includeArchived (boolean): 보관된 이슈 포함 여부 - limit (number, 기본값: 50): 최대 결과 수
linear_add_comment
이슈에 코멘트를 추가합니다. - 필수 입력: - issueId (string): 코멘트를 추가할 이슈 ID - body (string): 코멘트 텍스트 (마크다운 지원) - 선택적 입력: - createAsUser (string): 사용자 지정 이름 - displayIconUrl (string): 사용자 지정 아바타 URL
사용 방법
설치 및 구성
Linear MCP 서버는 두 가지 방법으로 설치할 수 있습니다:
1. Smithery를 통한 자동 설치 (권장)
npx @smithery/cli install linear-mcp-server --client claude2. 수동 설치
- Linear API 키 생성:
-
Linear 팀 설정에서 API 키를 생성합니다:
https://linear.app/YOUR-TEAM/settings/api -
Claude Desktop 구성 파일 수정:
- MacOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"linear": {
"command": "npx",
"args": ["-y", "linear-mcp-server"],
"env": {
"LINEAR_API_KEY": "your_linear_api_key_here"
}
}
}
}3. 공식 Linear 원격 MCP 서버 사용 (2025년 5월 이후)
Linear에서 공식 MCP 서버를 제공하기 시작했습니다:
{
"mcpServers": {
"linear": {
"url": "https://mcp.linear.app/sse"
}
}
}사용 예시
다음은 Claude Desktop에서 Linear MCP 서버를 사용하는 몇 가지 예시 프롬프트입니다:
- 우선순위가 높은 모든 이슈 보기:
"내게 할당된 모든 우선순위 높은 이슈를 보여줘"
이 프롬프트는 linear_search_issues 도구 또는 linear-user:///{userId}/assigned 리소스를 사용하여 우선순위가 1인 할당된 이슈를 찾습니다.
- 버그 리포트 생성:
"지금까지 설명한 내용을 바탕으로 인증 시스템에 대한 버그 리포트를 작성해줘"
이 프롬프트는 linear_create_issue를 사용하여 적절한 세부 정보와 상태 추적이 포함된 새로운 높은 우선순위 이슈를 생성합니다.
- 특정 상태의 이슈 검색:
"진행 중인 모든 프론트엔드 작업을 찾아줘"
이 프롬프트는 linear_search_issues를 사용하여 "진행 중" 상태의 프론트엔드 관련 이슈를 찾습니다.
- 이슈 업데이트 요약 확인:
"모바일 앱 개발 이슈에 대한 최근 업데이트 요약을 보여줘"
이 프롬프트는 linear_search_issues를 사용하여 관련 이슈를 식별한 다음, linear-issue:///{issueId}를 사용하여 이슈 세부 정보를 가져와 최근 활동과 코멘트를 표시합니다.
- 팀 작업 부하 분석:
"모바일 팀의 현재 작업 부하는 어떻게 되나요?"
이 프롬프트는 linear-team:///{teamId}/issues와 linear_search_issues를 조합하여 모바일 팀의 이슈 분포와 우선순위를 분석합니다.
보안 고려사항
- Linear API 키는 높은 권한을 가지므로 안전하게 보관해야 합니다.
- 환경 변수를 통해 API 키를 전달하고, 소스 코드나 공개 리포지토리에 포함하지 마세요.
- 프로덕션 환경에서는 필요한 최소한의 권한을 가진 API 키를 사용하세요.
- 민감한 프로젝트 정보나 개인 정보가 포함된 이슈 내용을 외부에 노출하지 않도록 주의하세요.
- 공유 환경에서는 API 키가 유출되지 않도록 보안 조치를 취하세요.